// Computer Program Listing Appendix Under 37 CFR 1 .52(e) 
// Entitlement.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved, 
package com. ffusion. entitlements; 

import java.util.ArrayList; 

I** 

This class represents a single Entitlement. 

7 

public class Entitlement implements EntitlementCodes 
{ 

// Fields 

public static final String ENTITLEMENT = "ENTITLEMENT"; 

public static final String ID = "ID"; 

public static final String NAME = "NAME"; 

public static final String LIMITS = "LIMITS"; 

// Data Members 

private String userName; 

private String userType = String.valueOf(CUSTOMER_USER_TYPE); 
private String name; // The name of the entitlement 
private String id; 

private ArrayList limits = new ArrayList(); 
private EntitlementService entService; 

private Limit currentLimit; 

I** 

Constructs a new Entitlement object. 

7 

public Entitlement) 

{ 

} 

r 

Gets the ArrayList collection of Limits. 

7 

public ArrayList getLimits() 
{ 

return limits; 

} 

I** 

* Sets currentLimit to the specified limit. 

* @param id the id of the limit. 

7 

public void setCurrentLimitByld(String id) 
{ 

this. currentLimit = this.getLimitByld(id); 

} 

/** 

* Sets currentLimit to the specified limit. 

* @param name the name of the limit. 

7 

public void setCurrentLimitByName(String name) 
{ 



this.currentLimit = this.getLimitByName(name); 

} 

/** 

* Gets the value of the current Limit object. 

* ©return the limit value as a String. 

7 

public String getCurrentLimitValueQ 
{ 

if(this.currentl_imit == null) 
return ""; 
else 

return currentLimit.getl_imitValue(); 

} 

I** 

Add a Limit into the ArrayList collection. 

@param I the limit to add. 

©return whether the add was successful 

7 

protected boolean addLimit(Limit I) 
{ 

if(l==null) 
return false; 
limits. add(l); 
return true; 

} 

I** 

Delete the Limit from the ArrayList collection. 
@param id the id of the Limit object. 
@return whether the delete was successful 

7 

protected boolean deleteLimitByld(String id) 
{ 

java.util. Iterator iterator = limits. iterator(); 

while (iterator. hasNext()) 

{ 

Limit nextLimit = (Limit) iterator. next(); 

if (nextLimit.getld().equals(id)) 

{ 

I i m its . remove( nextLi m it) ; 
return true; 

} 

} 

return false; 

} 

/** 

Delete the Limit from the ArrayList collection. 
@param name name of the Limit object. 
@return whether the delete was successful 

7 

protected boolean deleteLimitByName(String name) 



{ 

java.util. Iterator iterator = limits. iterator(); 

while (iterator. hasNext()) 

{ 

Limit nextLimit = (Limit) iterator. next(); 
if (nextLimit.getName().equals(name)) 
{ 

limits. remove (nextLimit); 
return true; 

} 

} 

return false; 

} 

I** 

Get the Limit from the ArrayList collection. 
@param id the id of the object. 

7 

protected Limit getLimitByld(String id) 
{ 

java.util. Iterator iterator = limits. iterator(); 

while (iterator. hasNext(J) 

{ 

Object o = iterator. next(); 
if(o instanceof Limit) 
{ 

if (((Limit)o).getld().equals(id)) 
return (Limit)o; 

} 

} 

return null; 

} 

/** 

Get the Limit from the ArrayList collection. 
@param name the name of the Limit object. 

7 

protected Limit getLimitByName(String name) 
{ 

int size = limits. size (); 

java.util. Iterator iterator = limits. iterator(); 

while (iterator. hasNext()) 

{ 

Object o = iterator. next(); 
if(o instanceof Limit) 
{ 

if (((Limit)o).getName().equals(name)) 
return (Limit)o; 

} 

} 

return null; 

} 



I** 

Set the Entitlement Service. This service is used 

when the Entitlement object is checking to see if any Limits 

have been exceeded. Running totals are checked and updated 

by using the service. 

@param service the Entitlement Service 

7 

protected void setEntService(EntitlementService service) 
{ 

this.entService = service; 

} 

I** 

Set the name of the Entitlement. 

@param nameParm the name of the entitlement. 

7 

public void setName(String nameParm) 
{ 

this. name = nameParm; 

} 

I** 

Get the name of the Entitlement, 
©return the name of the entitlement 

7 

public String getName() 
{ 

return this. name; 

} 

I** 

Set the id of the Entitlement. 
@param ID the id of the entitlement 

7 

public void setld(String ID) 
{ 

this. id = ID; 

} 

I** 

Get the id of the Entitlement. 
@return the id of the entitlement 

7 

public String getld() 
{ 

return this. id; 

} 

I** 

Set the userName of who this Entitlement is associated 
with. 

@param nameParm the userName associated with this entitlement. 

7 

public void setllserName(String nameParm) 
{ 



this.userName = nameParm; 

} 

/** 

Get the userName of who this Entitlement is associated 
with. 

@return the userName associated with this entitlement. 

7 

public String get(JserName() 
{ 

return this.userName; 

} 

I** 

Set the userType of who this Entitlement is associated 
with. 

@param type the userType associated with this entitlement. 

7 

public void setUserType(String type) 
{ 

this. userType = type; 

} 

I** 

Get the userType of who this Entitlement is associated 
with. 

@return the userType associated with this entitlement. 

7 

public String getUserType() 
{ 

return this. userType; 

} 

/** 

Creates and returns a copy of itself, 
©return an Entitlement object 

7 

protected Entitlement copy() 
{ 

Entitlement retEnt = new Entitlement); 

retEnt.setName (this.getName ()); 

Limit nextLimit = null; 

java.util. Iterator iterator = limits. iterator (); 

while (iterator. hasNext()) 

{ 

nextLimit = (Limit) iterator.next(); 
retEnt. addLimit(nextLimit.copy ()); 

} 

return retEnt; 

} 

I** 

Sets the Entitlement information in this object to 
the information in the Entitlement passed in. 
@param entitlement the Entitlement to use in setting. 



7 

public void set(Entitlement entitlement) 
{ 

this.setld (entitlement.getld ()); 

this.setUserName (entitlement.getUserName ()); 

this.setUserType (entitlement. getUserType ()); 

this.setName(entitlement.getNameO); 

this. limits = entitlement. limits; 

} 

I** 

* Gets all Limits that have been exceeded and populates the 

* exdLimits object passed. This object is null if no limits have 

* been exceeded. 

* @param Imtbl the Limitable object to check. 

* @param exdLimits the collection of limits that were exceed by the 

* Limitable object passed in. 

7 

public int getExceededLimits(Limitable Imtbl, ArrayList exdLimits) 
{ 

if(this.entService == null) 

return this.ERROR_NO_ENTITLEMENT_SERVICE_IN_BEAN; 
int iRet = SUCCESS_CODE; 
iRet = entService.getRunningTotals (limits); 
Limit nextLimit = null; 
java.util. Iterator iterator = limits. iterator (); 
while (iterator. hasNext()) 
{ 

nextLimit = (Limit) iterator. next(); 
if (nextLimit. isLimitExceeded (Imtbl)) 
{ 

exdLimits. add (nextLimit); 

iRet = this.ERROR_LIMITS_EXCEEDED; 

} 

} 

return iRet; 

} 

I** 

* Updates the running totals of all limits associated with this 

* Entitlement. 

* @param Imtbl The ValueLimitable object to use in updating. 

7 

protected int updateRunningTotals(ValueLimitable Imtbl) 
{ 

if(this.entService == null) 

return this.ERROR_NO_ENTITLEMENT_SERVICE_IN_BEAN; 
else if(!(lmtbl instanceof ValueLimitable)) 

return this.SUCCESS_CODE; 
else 

return entService.updateRunningTotals(lmtbl, limits); 

} 



I** 

* Rollsback the running totals of all limits associated with this 

* Entitlement. 

* @param Imtbl The ValueLimitable object to use in rolling back 

7 

protected int rollbackRunningTotals(ValueLimitable Imtbl) 
{ 

if(this.entService == null) 

return this.ERROR_NO_ENTITLEMENT_SERVICE_IN_BEAN; 
int iRet = SUCCESS_CODE; 
iRet = entService.getRunningTotals (limits); 
if(iRet == SUCCESS_CODE) 

iRet = entService.rollbackRunningTotals(lmtbl, limits); 
return iRet; 

} 

} 

// EntitlementCodes.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved, 
package com. ffusion. entitlements; 

/** 

Constants for the entitlements package. 

7 

public interface EntitlementCodes extends java.io.Serializable 
{ 

/** The code for success. Value is 0. 7 

static final int SUCCESS_CODE = 0; // No Error occurred 

//Bean Codes 

/** Error - the user is not entitled. Value is 14000. 7 
static final int ERROR_NOT_ENTITLED = 1 4000; 

/** Error - the user is entitled, but one or more limits have been exceeded. Value is 14001 . 7 
static final int ERROR_LIMITS_EXCEEDED = 14001; 

/** Error - the entitlement service is missing from a bean that requires one. Value is 14002. 7 
static final int ERROR_NO_ENTITLEMENT_SERVICE_IN_BEAN = 14002; 

/** Error - an attempt was made to add a null to the limit collection in an entitlement. Value is 14000. 7 
static final int ERROR_NO_LIMIT_TO_ADD = 14003; 

// Task Codes 

/** Error - no entitlement service. Value is 14100. 7 

static final int ERROR_NO_ENTITLEMENT_SERVICE = 1 41 00; 

/** Error - the entitlements collection is not in the session. Value is 14101 . 7 

static final int ERROR_NO_ENTITLEMENTS =14101; 

/** Error - an entitlements object is malformed. Value is 14102. 7 

static final int ERROR_MALFORMED_ENTITLEMENTS = 14102; 

/** Error - the user is not entitled to perform the task, or an 

entitlement object is required for the task to process, and the object is missing. Value is 141 03. 7 
static final int ERROR_NO_ENTITLEMENT = 14103; 
// static final int ERROR_NO_USER = 14104; 

/** Error - a limit object is required for the task to process, and the object is missing. Value is 14105. 7 
static final int ERROR_NO_LIMIT = 14105; 

/** Error - a limits collection is required for the task to process, and the object is missing. Value is 141 06. 7 
static final int ERROR_NO_LIMITS = 14106; 



/** Error - an entitlement name is missing. Value is 14107. 7 
static final int ERROR_NO_ENTITLEMENT_NAME = 14107; 
/** Error - the user is not entitled. Value is 14108. 7 

static final int ERROR_NO_ENTITLEMENT_FOR_THIS_OPERATION = 14108; 

/** Error - when copying entitlements, source and target collections need to be specified. 

If none are found, this error is created. Value is 141 09. 7 
static final int ERROR_NO_TARGET_OR_SOURCE_ENTITLEMENTS = 14109; 
/** Error - the limit has no name. Value is 141 10. 7 
static final int ERROR_NO_LIMIT_NAME =14110; 
/** Error - the entitlement service name is required, but not provided. Value is 141 1 1 . 7 
static final int ERROR_NO_ENTITLEMENT_SERVICE_NAME =14111; 
/** Error - the limit has no value. Value is 14112. 7 
static final int ERROR_NO_LIMIT_VALUE =14112; 
/** Error - a period type needs to be specified. Value is 141 13. 7 
static final int ERROR_NO_PERIOD_TYPE =14113; 
/** Error - a period needs to be specified. Value is 141 14. 7 
static final int ERROR_NO_PERIOD =14114; 
/** Error - no payee is specified when one is required. Value is 141 15. 7 
static final int E R RO R_N 0_P A Y E E l D =14115; 
/** Error - no account is specified when one is required. Value is 141 16. 7 
static final int ERROR_NO_ACCOUNT_ID =14116; 

/** Error - when validating a period limit, the period limit is determined to be malformed. Value is 141 17. 7 
static final int ERROR_MALFORMED_PERIOD_LIMIT = 1 41 1 7; 

/** Error - when validating a transaction limit, the limit is determined to be malformed. Value is 141 18. 7 
static final int ERROR_MALFORMED_TRANSACTION_LIMIT = 141 18; 
/** Error - when validating a Told limit, the limit is determined to be malformed. Value is 141 19. 7 
static final int ERROR_MALFORMED_TOID_LIMIT = 141 19; 

/** Error - when validating a Fromld limit, the limit is determined to be malformed. Value is 14120. 7 

static final int ERROR_MALFORMED_FROMID_LIMIT = 14120; 

/** Error - a day is specified that is not valid. Value is 14121 . 7 

static final int E R RO R_N OT_A_VA L I D_D A Y = 14121 ; 

/** Error - a week is specified that is not valid. Value is 14122. 7 

static final int ERROR_NOT_A_VALID_WEEK = 14122; 

/** Error - a month is specified that is not valid. Value is 14123. 7 

static final int ERROR_NOT_A_VALID_MONTH = 14123; 

/** Error - a year is specified that is not valid. Value is 14124. 7 

static final int E R RO R_N OT A VA L I D_Y EAR = 14124; 

/** Error - a period type is specified that is not valid. Valid values include 

DAILY, WEEKLY, MONTHLY, YEARLY. Value is 14125. 7 

static final int ERROR_NOT_A_VALID_PERIOD_TYPE = 14125; 

/** Error - an entitlement is required for the task to process, but none was found. Value is 1 4126. 7 
static final int ERROR_NO_ENTITLEMENT_FOUND = 14126; 

/** Error - a limit object is required for the task to process, but none was found. Value is 14127. 7 

static final int ERROR_NO_LIMIT_FOUND = 14127; 

/** Error - an entitlements name is required but not specified. Value is 14128. 7 

static final int ERROR_NO_ENTITLEMENTS_NAME = 14128; 

/** Error - no user id was specified when one was required. Value is 14129. 7 

static final int ERROR_NO_USER_ID = 14129; 

/** Error - no user type was specified when one was required. Value is 14130. 7 

static final int ERROR_NO_USER_TYPE = 1 41 30; 



/** Error - the limit object was malformed. Value is 14131 . 7 

static final int ERROR_MALFORMED_LIMIT =14131; 

/** Error - the entitlement group id is invalid. Value is 14132. 7 

static final int ERRORJNVALID_GROUPID = 14132; 

/** Error - the specified group type is invalid. Value is 14133. 7 

static final int ERROR_INVALID_GROUP_TYPE = 14133; 

//Constants 

/** The minimum value for a day in the year. Value is 1 . 7 
static final int M I N_ D AY_I N_Y EAR = 1 ; 
/** The maximum value for a day in the year. Value is 366. 7 
static final int MAX_DAY_IN_YEAR = 366; 

/** The minimum value for a month in the year. Months are zero-based. Value is 0. 7 
static final int MIN_MONTH_IN_YEAR = 0; 

/** The maximum value for a month in the year. Months are zero-based. Value is 1 1 . 7 
static final int MAX_MONTH_IN_YEAR =11; 

/** The minimum value for a week in the year. Weeks are zero-based. Value is 0. */ 

static final int MIN WEEK IN YEAR = 0; 

/** The maximum value for a week in the year. Value is 54. 7 

static final int M AXW E E K_ I N_ Y E A R = 54; 

/** The minimum value for a year value. Value is 1 . 7 

static final int MIN_YEAR = 1 ; 

/** The maximum value for a year value. Value is 5000000. 7 
static final int MAX_YEAR = 5000000; 

//User type defines 

/** User types are used to differentiate between users that may have the 

same id, but are different types. Customer User Type. Value is 1 . 7 

static final int CUSTOMER_USER_TYPE = 1 ; 

/** User types are used to differentiate between users that may have the 

same id, but are different types. Employee User Type. Value is 2. 7 

static final int EMPLOYEE_USER_TYPE = 2; 

/** User types are used to differentiate between users that may have the 

same id, but are different types. Group User Type. Value is 4. 7 

static final int GROUP_USER_TYPE = 4; 

//Common Limit values to validate bean information 

static final String LIMITJD = "LIMITJD"; 

static final String LIMIT_NAME = "LIMITNAME"; 

static final String LIMIT VALUE = "LIMIT_VALUE"; 

static final String PERIOD = "PERIOD"; 

static final String PAYEEID = "PAYEEID"; 

static final String ACCOUNTID = "ACCOUNTID"; 

} 

// Entitlements Java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved, 
package com. ffusion. entitlements; 
import java.util.ArrayList; 

import java.util.HashMap; 

I** 

This class represents a collection of Entitlements for a specific user. 

Entitlements are used to determine whether a particular task, or function may be performed. 

7 



public class Entitlements extends ArrayList implements EntitlementCodes 
{ 

// Data Members 
private String userld; 

private String userType = String .valueOf (CUSTOM E R_US E R_TYP E) ; 

private ArrayList exceededLimits; 

private Entitlement currentEntitlement; 

private Limit currentLimit; 

private Entitlements usersEnts; 

private EntitlementService svc; 

private boolean initialize = true; 

private HashMap uniqueLimits = new HashMap(); 

private static final String USERJD = "ID"; 

private static final String USER TYPE = "TP"; 

/** 

* Constructs a new Entitlements object for a given locale. 

7 

protected Entitlements() 

{ 

} 

I** 

* Constructs a new Entitlements object for a given user. 

* @param id the userid of the current user. 

* @param type the usertype of the current user. 

* @param entSvc the service used. 

* @param ents the Entitlements of of the current user. 

* @return Entitlements object 
7 

public Entitlements(String id, String type, EntitlementService entSvc, Entitlements ents) 
{ 

this. userld = id; 
this. userType = type; 
this. svc = entSvc; 

if(ents != null && id.equals (ents.getUserld ()) && type.equals(ents.getUserType ())) 
this. usersEnts = null; 
else 

this. usersEnts = ents; 

} 

I** 

* Overriding the ArrayList addAII method. This method does nothing and returns false. 

* @param c the collection to add. 

7 

public boolean addAII(java.util. Collection c) 
{ 

return false; 

} 

I** 

* Overriding the ArrayList addAII method. This method does nothing and returns false. 

* @param c the collection to add. 

* @param index the index to add at. 



7 

public boolean addAII(int index, java.util. Collection c) 
{ 

return false; 

} 

J** 

* Adds the Object o to the Array List. If the object is not an Entitlement, this method 

* returns false. Otherwise the method tries to add the object. 

* @param o the object to add. 

7 

public boolean add(Object o) 
{ 

if (o instanceof Entitlement) 
{ 

((Entitlement)o).setEntService(svc); 

//We let them add entitlements if the entitlements object is being 
//initialized, otherwise we check the validateAddEntitlement method 
if (initialize || validateAddEntitlement((Entitlement)o) == SUCCESS_CODE) 
return super.add (o); 

} 

return false; 

} 

I** 

* Adds the Object o to the Array List. If the object is not an Entitlement, this method 

* returns false. Otherwise the method tries to add the object. 

* @param index the spot to add the object at. 

* @param o the object to add. 

7 

public void add(int index, Object o) 
{ 

if(o instanceof Entitlement) 
{ 

((Entitlement)o).setEntService(svc); 

//We let them add entitlements if the entitlements object is being 
//initialized, otherwise we check the validateAddEntitlement method 
if(initialize || validateAddEntitlement((Entitlement)o) == SUCCESS_CODE) 
super.add(index,o); 

} 

} 

I** 

* Removes the Object from the Array List by Name. If the object is not an Entitlement, this method 

* returns false. Otherwise the method tries to remove the object. 

* @param Name the name of the Entitlement to remove. 

7 

public boolean remove(String Name) 
{ 

return remove(get(Name)); 

} 

/** 

* Removes the Object o from the Array List. If the object is not an Entitlement, this method 



* returns false. Otherwise the method tries to remove the object. 

* @param o the object to remove. 

7 

public boolean remove(Object o) 
{ 

if(o instanceof Entitlement) 
{ 

if (initialize || validateEntitlement((Entitlement)o) == SUCCESS_CODE) 
return super. remove(o); 

} 

return false; 

} 

I** 

* Removes the Object from the Array List at the index i. 

* @param i the index of the object to remove. 

7 

public Object remove(int i) 
{ 

return super.remove(i); 

} 

I** 

Delete the Limit from the ArrayList collection. 
@param name name of the Limit object. 

7 

public int deleteLimit(String limitName, String entName) 
{ 

int errorCode = validateDeleteLimit(limitName,entName); 

if(errorCode == SUCCESS_CODE) 

{ 

Entitlement AdminEnt = get(entName); 
AdminEnt.deleteLimitByName(limitName); 

} 

return errorCode; 

} 

I** 

Delete the Limit from the ArrayList collection. 
@param name name of the Limit object. 

7 

public int modifyLimit(Limit lim, String entName) 
{ 

int errorCode = validateAddLimit(lim,entName); 

if(errorCode == SUCCESS_CODE) 

{ 

Limit I = (Limit)uniqueLimits.get(lim.getld ()); 

if(l == null && validateAddLimit(lim, entName) == SUCCESS_CODE) 
{ 

deleteLimit(lim.getName(), entName); 
addLimit(lim, get(entName)); 

} 

else 



I.set (lim); 

} 

return errorCode; 

} 

private void modifyLimit(Limit lim, Entitlement ent) 
{ 

//Limit NmitToAdd = lim. copy (); 
Limit I = ent.getLimitByName(lim.getName ()); 
if(l == null) 
ent.addLimit(lim); 
else 
{ 

ent.deleteLimitByName(lim.getNameO); 
lim.setld(l.getld ()); 
ent.addLimit(lim); 

} 

} 

private int validateEntitlement(Entitlement e) 
{ 

//If they are trying to modify their own entitlements, we fail. 
if(usersEnts == null) 

return ERROR_NOT_ENTITLED; 
// If entitlement name is null or empty, we fail. 
if((e.getName() == null) || (e.getName().equals( MM ))) 

return ERROR_NO_ENTITLEMENT_NAME; 
//We return if we passed in nulls 
if(e==null) 

return ERROR_NO_ENTITLEMENT; 

//If the entitlement does not exist in the user's collection, we fail 
if(!isUserEntitled(e.getName())) 
return ERROR_NOT_ENTITLED; 
return SUCCESS_CODE; 

} 

private int validateAddEntitlement(Entitlement e) 
{ 

int errorCode = validateEntitlement(e); 
if(errorCode != SUCCESS_CODE) 
return errorCode; 

Entitlement UserEnt = usersEnts.get(e.getNameQ); 

//Now check to make sure that any limits the user's entitlement has, 

//is not exceeded and that any limits the user has is added to the list 

ArrayList lims = UserEnt.getLimits(); 

for(int i = 0; i < lims. size (); i++) 

{ 

Limit userLimit = (Limit)lims.get(i); 

Limit existingLimit = e.getLimitByName(userLimit.getName()); 

if(existingLimit != null) 

{ 

if(userLimit.isLimitExceeded(existingLimit)) 
return ERROR_NOT_ENTITLED; 



} 

} 

for(int i = 0; i < lims.size (); 
{ 

Limit userLimit = (Limit)lims.get(i); 

Limit existingLimit = e.getLimitByName(userLimit.getName()); 
if(existingLimit != null) 
modifyLimit(existingLimit, e.getName()); 
else 
{ 

Limit copy = userLimit.copy(); 
addLimit(copy, e); 

} 

} 

return errorCode; 

} 

private int validateDeleteLimit(String limName, String entName) 
{ 

int errorCode = SUCCESS_CODE; 

//If they are trying to modify their own entitlements, we fail. 

if(usersEnts == null) 

return ERROR_NOT_ENTITLED; 
//We return if we passed in nulls 
if(limName==null) 

return ERROR_NO_LIMIT_NAME; 
if(entName == null) 

return ERROR_NO_ENTITLEMENT_NAME; 
//Get the entitlement from this collection 
errorCode = isEntitled(entName); 
if(errorCode != SUCCESS_CODE) 
return ERROR_NOT_ENTITLED; 
Entitlement UserEnt = usersEnts.get(entName); 
if(UserEnt != null && UserEnt.getLimitByName(limName) != null) 
return ERROR_NOT_ENTITLED; 
else 

return SUCCESS_CODE; 

} 

private int validateAddLimit(Limit I, String entName) 
{ 

int errorCode = SUCCESS_CODE; 
//If they are trying to modify their own entitlements, we fail. 
if(usersEnts == null) 
return ERROR_NOT_ENTITLED; 
//We return if we passed in nulls 
if(l==null) 

return ERROR_NO_LIMIT_TO_ADD; 
if(entName == null) 

return ERROR_NO_ENTITLEMENT_NAME; 
if (l.getNameO == null || l.getName().equals( ,m )) 
return ERROR_NO_LIMIT_NAME; 



//Get the entitlement from this collection 
errorCode = isEntitled(entName); 
if(errorCode != SUCCESS_CODE) 
return ERROR_NOT_ENTITLED; 

//If the entitlement does not exist in the user's collection, we fail 
if(!isUserEntitled(entName)) 
return ERROR_NOT_ENTITLED; 
Entitlement UserEnt = usersEnts.get(entName); 
//Now check to make sure that any limits the user's entitlement has, 
//is not exceeded. 

Limit UserLim = UserEnt.getLimitByName(l.getName ()); 
if(Userl_im != null && UserLim. isLimitExceeded(l)) 
return ERROR_LIMITS_EXCEEDED; 
else 

return SUCCESS_CODE; 

} 

I** 

Add a Limit into the Entitlement specified. 
@param I the limit to add. 

@param entName the name of the Entitlement to add to. 

7 

public int addLimit(Limit I, String entName) 
{ 

int errorCode = validateAddLimit(l, entName); 
//We let them add limits, if the entitlements object is being 
//initialized, otherwise we check the validateAddLimit method 
if(initialize || errorCode == SUCCESS_CODE) 

{ 

Entitlement adminEnt = get(entName); 
addLimit(l, adminEnt); 

} 

return errorCode; 

} 

private void addLimit(Limit I, Entitlement ent) 
{ 

if (I != null && ent != null) 
{ 

modifyLimitld(l); 

if(uniqueLimits.get(l.getld ()) != null) 
I = (Limit)uniqueLimits.get(l.getld ()); 
else 

uniqueLimits.put(l.getld (),l); 
//Now just add the limit 
ent.addLimit(l); 

} 

} 

private void modifyLimitlds() 
{ 

Limit I = null; 

java.util. Iterator it = uniqueLimits.values (). iterator (); 



while(it.hasNext ()) 
{ 

Object o = it.next(); 
if(o instanceof Limit) 
{ 

modifyLimitld((Limit)o); 

} 

} 

} 

private void modifyLimitlds(Entitlement ent) 
{ 

Limit I = null; 

java.util. Iterator it = ent.getLimits (). iterator (); 

while(it.hasNext ()) 

{ 

Object o = it.next(); 
if(o instanceof Limit) 
{ 

modifyLimitld((Limit)o); 

} 

} 

} 

private void modifyLimitld(Limit I) 
{ 

String id = l.getld (); 
if(id.indexOf(USER_ID) != -1) 
id = id.substring(0,id.indexOf(USER_ID)); 

id = id + USERJD + this.getUserld () + USER_TYPE + this.getUserType (); 
l.setld(id); 

if(uniqueLimits.get(id) == null) 
uniqueLimits.put(id, I); 

} 

I** 

Makes the Entitlements object passed in a copy of itself. 
@param ents the object that will be the copy. 

7 

public void copy(Entitlements ents) 
{ 

Object o = null; 
Entitlement e = null; 
ents.clear(); 

java.util. Iterator it = this. iterator (); 

while(it.hasNext ()) 

{ 

o = it. next (); 

if(o instanceof Entitlement) 
ents.add(((Entitlement)o).copy()); 

} 

} 

I** 



* Gets the user id for whose entitlements are contained in this collection. 

* ©return the userid. 

7 

public String get(Jserld() 
{ 

return userid; 

} 

I** 

* Gets the user type for whose entitlements are contained in this collection. 

* ©return the user type. 

7 

public String getUserType() 
{ 

return userType; 

} 

I** 

* Gets the Entitlement. 

* @param name the name of the Entitlement. 

* ©return the Entitlement. 

7 

public Entitlement get(String name) 
{ 

if(name == null) 
return null; 

java.util. Iterator iterator = iterator(); 

while (iterator. hasNext()) 

{ 

Entitlement nextEnt = (Entitlement) iterator. next(); 

if (name.equals(nextEnt.getName ())) 

{ 

return nextEnt; 

} 

} 

return null; 

} 

I** 

* Gets the Entitlement. 

* @param id the id of the Entitlement. 

* @return the Entitlement. 

7 

public Entitlement getByld(String id) 
{ 

if(id == null) 
return null; 

java.util. Iterator iterator = iterator(); 

while (iterator. hasNext()) 

{ 

Entitlement nextEnt = (Entitlement) iterator. next(); 

if (nextEnt.getld ().equals (id)) 

{ 



return nextEnt; 

} 

} 

return null; 

} 

I** 

Get the Limit from the ArrayList collection. 
@param entName the name of the entitlement. 
@param limitld the id of the Limit, 
©return the Limit requested 

7 

public Limit getLimitByld(String entName, String limitld) 
{ 

Entitlement ent = get(entName); 
if(ent!=null) 

return ent.getLimitByld(limitld); 
else 

return null; 

} 

I** 

Get the Limit from the ArrayList collection. 
@param entName the name of the entitlement. 
@param limitName the name of the Limit. 
@return the Limit requested 

7 

public Limit getLimitByName(String entName, String limitName) 
{ 

Entitlement ent = get(entName); 
if(ent!=null) 

return ent.getLimitByName(limitName); 
else 

return null; 

} 

I** 

* Returns whether the entitlement exists and whether any limits are broken. 

* If entitlement exists and no limits are broken, then Running Totals are 

* updated. This should be called immediately before a TransactionLimitable object 

* executes its transaction. 

* @param EntitlementName the name of the entitlement to check. 

* @param Imtbl the Limitable object to check against. 

* @return integer of whether or not it succeeded 0-means SUCCESS. 

7 

public int isEntitled(String EntitlementName, Limitable Imtbl) 
{ 

int iret = SUCCESS_CODE; 
this.exceededLimits = new ArrayList(); 
Entitlement ent = this.get(EntitlementName); 
if (ent == null) 

iret = this.ERROR_NOT_ENTITLED; 
else 



{ 

iret = ent.getExceededLimits (Imtbl, this.exceededLimits); 
int sizeofLimits = this.exceededLimits. size (); 
if(iret == SUCCESS_CODE && Imtbl instanceof ValueLimitable) 
iret = ent.updateRunningTotals((ValueLimitable)lmtbl); 

} 

return iret; 

} 

/** 

* Rolls back the running total update that was made when isEntitled is called. Normal 

* processing in a Limitable object is to have the call to isEntitled be made immediately before 

* the Limitable's transaction. If isEntitled returns true, then the transaction is processed. 

* If the transaction fails, then this method is called to rollback the running total call. 

* @param EntitlementName the name of the entitlement that was checked. 

* @param Imtbl the Limitable object that was checked. 

* @return integer of whether or not it succeeded 0-means SUCCESS. 
7 

public int rollbackRunningTotals(String EntitlementName, Limitable Imtbl) 
{ 

int iret = SUCCESS_CODE; 

Entitlement ent = this.get(EntitlementName); 

if (ent == null) 

iret = this. ERROR_NOT_ENTITLED; 
else if(lmtbl instanceof ValueLimitable) 

iret = ent.rollbackRunningTotals((ValueLimitable)lmtbl); 
return iret; 

} 

private boolean isUserEntitled(String EntitlementName) 
{ 

return (usersEnts.get(EntitlementName) != null); 

} 

/** 

* Returns whether the entitlement exists in this this Entitlements collection. 

* @param EntitlementName the name of the Entitlement. 

* ©return integer of whether or not it exists 0-means exists. 

7 

public int isEntitled(String EntitlementName) 
{ 

Entitlement ent = this.get(EntitlementName); 
if (ent == null) 

return this.ERROR_NOT_ENTITLED; 
else 

return this.SUCCESS_CODE; 

} 

/** 

* Sets the current entitlement object for the entitlement whose 

* name is passed in. 

* @param name the name of the Entitlement to set as current. 

7 

public void setCurrentEntitlement(String name) 



{ 

this.currentEntitlement = null; 
if(name == null) 
return; 

java.util. Iterator iterator = iterator(); 

while (iterator. hasNextQ) 

{ 

Entitlement nextEnt = (Entitlement) iterator. next(); 

if (nextEnt.getName (). equals (name)) 

{ 

this.currentEntitlement = nextEnt; 
return; 

} 

} 

} 

I** 

* Gets whether the current entitlement exists 

* @return boolean of whether the entitlement exists or not. 

7 

public boolean getCurrentEntitlement() 
{ 

if(this.currentEntitlement != null) 
return true; 
else 

return false; 

} 

I** 

* Sets the current limit object for the limit whose 

* name is passed in. 

* @param name the name of the limit to set as current. 

7 

public void setCurrentl_imit(String name) 
{ 

this.currentLimit = null; 

if (name == null || this.currentEntitlement == null) 
return; 

this.currentLimit = this.currentEntitlement.getLimitByName (name); 
} 

I** 

* Gets the value of the current limit 

* return String the Value of the current limit. 

7 

public String getCurrentl_imitValue() 
{ 

if(this.currentl_imit != null && this.currentLimit.getLimitValue () != null) 
return this.currentLimit.getLimitValue (); 
else 

return ""; 

} 

I** 



* Gets the exceeded limits of a failed entitlement search 

* ©return ArrayList of the Limits that were exceeded by the most recent call to isEntitled. 

7 

public ArrayList getExceededLimits() 
{ 

return this.exceededLimits; 

} 

I** 

* Sets the initialize boolean to false. This boolean is used to determine 

* whether or not the Entitlements object is initializing. This allows the 

* service implementation to add to the object, and then to set this flag 

* disallowing illigitimate modifications. 

7 

public void setlnitialize() 
{ 

this. initialize = false; 

} 

} 

// FromldLimit.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved. 

package com. ffusion. entitlements; 

import java.util. Locale; 

import java.util. ArrayList; 

import java.util. Iterator; 

import java.util.*; 

import java.util. HashMap; 

I** 

* This class contains a list of all ids that are not entitled for the task. 

7 

public class FromldLimit implements Limit, EntitlementCodes 
{ 

// Data members 
private String id; 
private String name; 

private String limitValue; 

I** 

* Constructs a new FromldLimit object. 

7 

public FromldLimitO 

{ 

} 

/** 

* Gets the list of Fromlds. 

* @return Collection containing the Fromlds that are excluded from the Entitlement. 

7 

public ArrayList get From lds() 
{ 

ArrayList 1st = new Array List(); 

StringTokenizer parser = new StringTokenizer(limitValue,", M ); 
while(parser.hasMoreTokens ()) 



{ 

String str = (String)parser.nextToken (); 
Ist.add(str); 

} 

return 1st; 

} 

* Sets the list of From Ids. 

* @param From Ids the list of From Ids that are excluded from the Entitlement. 

7 

public void set From lds( Array List Fromlds) 
{ 

boolean bfirst = true; 

StringBuffer sbuf = new StringBuffer(); 

java.util. Iterator iterator = From Ids. iterator (); 

if( iterator, has Next ()) 

{ 

if(!bfirst) 

sbuf.append(V'); 
bfirst = false; 

Object nextVal = iterator. next(); 
sbuf.append(nextVal.toString ()); 

} 

this.limitValue = sbuf.toString (); 

} 

/** 

* Sets the id property. 

* @param sld the id of the limit. 

7 

public void setld(String sld) 
{ 

this. id = sld; 

} 

I** 

* Gets the id property. 

* <§>return the id of the limit. 

7 

public String getld() 
{ 

return this. id; 

} 

/** 

* Sets the name property. 

* @param sName the Name of the limit. 

7 

public void setName(String sName) 
{ 

this. name = sName; 

} 

I** 



* Gets the name property. 

* @return the Name of the limit. 

7 

public String getName() 
{ 

return this. name; 

} 

I** 

* Gets the limitValue associated with this Limit. 

* @return the Limit Value. 

7 

public String getLimitValueQ 
{ 

return limitValue; 

} 

I** 

* Sets the limitValue associated with this Limit. 

* @param the Limit Value. 

7 

public void setLimitValue(String s) 
{ 

limitValue = s; 

} 

I** 

Creates and returns a copy of itself. 
<§>return a Limit object 

7 

public Limit copy() 
{ 

FromldLimit retLim = new FromldLimit(); 
retLim.setld (this.getld ()); 
retLim. setName (this.getName ()); 
retLim.setLimitValue (this.getLimitValue ()); 
return retLim; 

} 

I** 

sets the Limit information in this object based on the Limit passed in 
@param lim object passed in to use in the set. 

7 

public void set(Limit lim) 
{ 

if (lim != null && lim instanceof FromldLimit) 
{ 

this.setld (lim.getld ()); 
this.setName (lim.getName ()); 
this.setLimitValue (Hm.getLimitValue ()); 

} 

} 

I** 

Checks to see whether the Limit object has limit values that exceed the Limit. 



@param limit the object to check the limit against, 
©return Whether the limit was exceeded. 

7 

public boolean isl_imitExceeded(l_imit limit) 
{ 

if (limit instanceof FromldLimit) 
{ 

FromldLimit Mm = (FromldLimit)limit; 

String checkLimitValue = lim.getl_imitValue(); 

String value; 

String checkValue; 

boolean bFound = false; 

StringTokenizer userParser = new StringTokenizer(limitValue,","); 

while(userParser.hasMoreTokens ()) 

{ 

bFound = false; 

value = (String)userParser.nextToken (); 

StringTokenizer parser = new StringTokenizer(checkLimitValue,Y); 

while(parser.hasMoreTokens ()) 

{ 

checkValue = (String)parser.nextToken (); 
if (checkValue. equals(value)) 
bFound = true; 

} 

//If we can't find this, the limit is exceeded 
if(lbFound) 
return true; 

} 

} 

return false; 

} 

/** 

Checks to see if the object coming in is going to exceed the limit. 
@param Imtbl the object to be tested 
©return Whether this limit was exceeded 

7 

public boolean isLimitExceeded(Limitable limitable) 
{ 

if (limitable instanceof FromldLimitable) 
{ 

FromldLimitable limit = (FromldLimitable) limitable; 
String Fromld = limit.getLimitableFromlD(); 
//if there is no limitable id, we will return false 
if(Fromld == null) 
return false; 

StringTokenizer parser = new StringTokenizer(limitValue,", M ); 

while(parser.hasMoreTokens ()) 

{ 

String value = (String)parser.nextToken (); 

// If the Fromld is found in this limit, the limit is exceeded. 



// Thus, the task cannot be performed, 
if (Fromld.compareTo(value) == 0) 
return true; 

} 

} 

return false; 

} 

I** 

Gets the Name Value pairs of the Limit 
©return the Name/Value pairs. 

7 

public HashMap getNameValuePairs() 
{ 

HashMap map = new HashMapQ; 
if(this.getl_imitValue () != null) 
{ 

map.put( M LimitValue M ,this.getLimitValue ()); 

} 

return map; 

} 

} 

// Limit.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved, 
package com. ffusion. entitlements; 

import java.util. HashMap; 

I** 

An object is a Limit if it implements this interface. 

7 

public interface Limit extends java.io.Serializable 
{ 

I** 

Checks to see whether the Limitable object would exceed the Limit. 
@param limitable the object to check the limit against. 
@return Whether the limit was exceeded. 

7 

public boolean isLimitExceeded(Limitable limitable); 

I** 

Checks to see whether the Limit object has limit values that exceed the Limit. 
@param limit the object to check the limit against, 
©return Whether the limit was exceeded. 

7 

public boolean isLimitExceeded(Limit limit); 

I** 

Creates and returns a copy of itself, 
©return a Limit object 

7 

public Limit copy(); 

I** 

Gets the Id of the Limit 
@return the Id. 



7 

public String getld(); 

/** 

Sets the Id of the Limit 
@param id the Id. 

7 

public void setld(String id); 

I** 

Gets the Name of the Limit 
©return the Name. 

7 

public String getName(); 

I** 

Sets the Name of the Limit 
@param sName the Name. 

7 

public void setName(String sName); 

I** 

Gets the Limit Value of the Limit 
©return the Limit Value. 

7 

public String getLimitValue(); 

I** 

Gets the Name Value pairs of the Limit 
©return the Name/Value pairs. 

7 

public HashMap getNameValuePairs(); 

I** 

sets the Limit information in this object based on the Limit passed in 
@param lim object passed in to use in the set. 

7 

public void set(Limit lim); 

} 

// PeriodLimit.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved, 
package com. ffusion. entitlements; 
import java.util. Locale; 
import java.text.*; 
import java.util. Calendar; 

import java.util. HashMap; 

I** 

This class represents a single PeriodLimit. 

7 

public class PeriodLimit implements Limit, EntitlementCodes 
{ 

/** The DAILY static variable is used to specify Daily Period Limits. Value is "DAILY". 7 
public static final String DAILY = "DAILY"; 

/** The WEEKLY static variable is used to specify Weekly Period Limits. Value is "WEEKLY". 7 
public static final String WEEKLY = "WEEKLY"; 

/** The MONTHLY static variable is used to specify Monthly Period Limits. Value is "MONTHLY". 7 



public static final String MONTHLY = "MONTHLY"; 

/** The YEARLY static variable is used to specify Yearly Period Limits. Value is "YEARLY". 7 
public static final String YEARLY = "YEARLY"; 
// Data Members 
private String id; 
private String name; 

private String periodType = DAILY; // Type of period-- Defaults to DAILY 
private int period = Calendar.SUNDAY; // period-Defaults to Sunday 
private String accountld; // Unique ID of the account 
private String payeeld; // Unique ID of the payee 
private double runningTotal; 

private double limit; // Limit to compare 

I** 

Constructs a new Period Limit object 

7 

public PeriodLimitO 

{ 

} 

/** 

Set the periodType property 

@param typeParm the periodType of the periodLimit 

7 

public void setPeriodType(String typeParm) 
{ 

this. periodType = typeParm; 
} 

J** 

Get the periodType property-this defaults to DAILY 
@return periodType 

7 

public String getPeriodType() 
{ 

return this. periodType; 

} 

I** 

Set the period property 

@param periodParm the period of the periodLimit 

7 

public void setPeriod(String periodParm) 
{ 

try{ 

this. period = Integer.parselnt (periodParm); 

} 

catch( NumberFormatException e ){ 
this. period = 0; 

} 

} 

Get the period property-This is the numeric representation of the period. 
Numeric values may be viewed in EntitlementCodes as M I N_D A Y_ I N_Y EAR... 



@return period 

7 

public String getPeriodQ 
{ 

return Integer.toString (period); 

} 

Set the accountld property 

@param idParm the accountld of the periodLimit 

7 

public void setAccountlD(String idParm) 
{ 

this. accountld = idParm; 

} 

/** 

Get the accountld property 
©return accountld 

7 

public String getAccountlDQ 
{ 

return this. accountld; 

} 

I** 

Set the payeeld property 

@param idParm the payeeld of the periodLimit 

7 

public void setPayeelD(String idParm) 
{ 

this. payeeld = idParm; 

} 

I** 

Get the payeeld property 
@ return payeeld 

7 

public String getPayeelD() 
{ 

return this. payeeld; 

} 

I** 

Set the limit property 

@param Limit the limit of the periodLimit 

7 

public void setLimitValue(String Limit) 
{ 

try{ 

this. limit = Double.parseDouble (Limit); 

} 

catch( NumberFormatException e ){ 
} 

} 



I** 

Creates and returns a copy of itself. 
@return a Limit object 

7 

public Limit copy() 
{ 

PeriodLimit retLim = new PeriodLimit(); 
retLim.setld (this.getld ()); 
retLim.setAccountID (this.getAccountID ()); 
retLim. set PayeelD (this.getPayeelD ()); 
retLim.setLimitValue (this.getLimitValue ()); 
retLim. setName (this.getName ()); 
retLim. set Period (this.getPeriod ()); 
retLim. set PeriodType (this. get PeriodType ()); 
return retLim; 

} 

I** 

sets the Limit information in this object based on the Limit passed in 
@param lim object passed in to use in the set. 

7 

public void set(Limit lim) 
{ 

if (lim != null && lim instanceof PeriodLimit) 
{ 

PeriodLimit periodLimit = (PeriodLimit)lim; 

this.setAccountID (periodLimit.getAccountID ()); 

this.setld (periodLimit.getld ()); 

this.setLimitValue (periodLimit.getLimitValue ()); 

this.setName (periodLimit. getName ()); 

this.setPayeelD (periodLimit.getPayeelD ()); 

this.setPeriod (periodLimit.getPeriod ()); 

this.setPeriodType (periodLimit. getPeriodType ()); 

this.setRunningTotalValue(periodLimit.getRunningTotalValue ()); 

} 

} 

I** 

* Sets the id property. 

* @param sld the id of the limit. 

7 

public void setld(String sld) 
{ 

this. id = sld; 

} 

I** 

* Gets the id property. 

* @return the id of the limit. 

7 

public String getld() 
{ 

return this. id; 



} 

I** 

* Sets the name property. 

* @param sName the Name of the limit. 

7 

public void setName(String sName) 
{ 

this. name = sName; 

} 

I** 

* Gets the name property. 

* @return the Name of the limit. 

7 

public String getName() 
{ 

return this. name; 

} 

I** 

* Gets the limitValue associated with this Limit. 

* @return the Limit Value. 

7 

public String getLimitValue() 
{ 

return String.valueOf(this. limit); 

} 

/** 

* Sets the runningTotal property. 

* @param s the runningTotal. 

7 

public void setRunningTotal(String s) 
{ 

this. runningTotal = Double. parseDouble(s); 

} 

I** 

* Gets the runningTotal property. 

* <§>return the running total for this limit. 

7 

public String getRunningTotal() 
{ 

return String.valueOf(this. runningTotal); 

} 

/** 

* Sets the runningTotal property. 

* @param d the runningTotal. 

7 

public void setRunningTotalValue(double d) 
{ 

this. runningTotal = d; 

} 

I** 



* Gets the runningTotal property. 

* @return the running total for this limit as a double. 

7 

public double getRunningTotalValue() 
{ 

return this. runningTotal; 

} 

I** 

Checks to see whether the Limit object has limit values that exceed the Limit. 
@param limit the object to check the limit against. 
@return Whether the limit was exceeded. 

7 

public boolean isLimitExceeded(Limit checkLim) 
{ 

if(checkLim instanceof PeriodLimit) 
{ 

PeriodLimit Mm = (PeriodLimit)checkLim; 
if(!lim.getPeriodType().equals(getPeriodType ())) 
return false; 
try 
{ 

if(Double.valueOf(lim.getLimitValue()).doubleValue () > limit ) 
return true; 

} 

catch( Exception e) 
{ 

return false; 

} 

} 

return false; 

} 

/** 

Checks to see if the object coming in is going to exceed the limit. 

@param Imtbl the object to be tested 

©return boolean value of whether this limit was exceeded 

7 

public boolean isLimitExceeded(Limitable Imtbl) 
{ 

boolean bret = false; 
boolean bCheck = true; 

//If this is not a TransactionLimitable object, we won't check 

if(lmtbl instanceof TransactionLimitable) 

{ 

TransactionLimitable txnLmt = (TransactionLimitable) Imtbl; 
//If we are returning nulls out of this, we will return false 
if(this.accountld != null && txnLmt.getLimitableFromlD() == null) 
return false; 

if(this.payeeld != null && txnLmt.getLimitableTolD() == null) 
return false; 

if(txnLmt.getLimitableValue() == null) 



return false; 

//if we have an account, and they are not equal, we don't need to check 
if(this.accountld != null && !(txnLmt.getLimitableFromlD (). equals (this.accountld))) 
bCheck = false; 

//if we have an account, and they are not equal, we don't need to check 

if(bCheck && this.payeeld != null && !(txnLmt.getLimitableTolD (). equals (this.payeeld))) 

bCheck = false; 

//If we are supposed to check, and the limit is exceeded, we note that 
if(bCheck) 

{ 

if(limit < (txnLmt.getLimitableValue Q.doubleValue () + runningTotal)) 
bret = true; 

} 

} 

return bret; 

} 

I** 

Gets the Name Value pairs of the Limit 
@return the Name/Value pairs. 

7 

public HashMap getNameValuePairsQ 
{ 

HashMap map = new HashMap(); 
if(this.getl_imitValue () != null) 

map.put("LimitValue",this.getLimitValue ()); 
if(this.getAccountlD () != null) 

map.put("AccountlD",this.getAccountlD ()); 
if(this.getPayeelD () != null) 

map.put("PayeelD",this.getPayeelD ()); 
if(this.getPeriodType () != null) 

map.put("PeriodType",this.getPeriodType ()); 
if(this.getld () == null || this.getld (). length () == 0) 
{ 

map.put("RunningTotal",getRunningTotal()); 
map.put("Period",getPeriod()); 

} 

return map; 

} 

} 

//ToldLimit.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved. 

package com. ffusion. entitlements; 

import java.util. Locale; 

import java.util. ArrayList; 

import java.util. Iterator; 

import java.util.*; 

import java.util. HashMap; 

I** 

* This class contains a list of all ids that are not entitled for the task. 

7 



public class ToldLimit implements Limit, EntitlementCodes 
{ 

// Data members 
private String id; 
private String name; 

private String limitValue; 

I** 

* Constructs a new ToldLimit object. 

7 

public ToldLimitO 

{ 

} 

J** 

* Gets the list of Tolds. 

* @return ArrayList containing the Tolds that are excluded from the Entitlement. 

7 

public ArrayList getTolds() 
{ 

ArrayList 1st = new Array List(); 

StringTokenizer parser = new StringTokenizer(limitValue,", M ); 

while(parser.hasMoreTokens ()) 

{ 

String str = (String)parser.nextToken (); 
Ist.add(str); 

} 

return 1st; 

} 

I** 

* Sets the list of Tolds. 

* @param Tolds the list of Tolds that are excluded from the Entitlement. 

7 

public void setTolds(ArrayList Tolds) 
{ 

boolean bfirst = true; 

StringBuffer sbuf = new StringBuffer(); 

java.util. Iterator iterator = Tolds. iterator (); 

if( iterator, has Next ()) 

{ 

if(!bfirst) 

sbuf.append(V); 
bfirst = false; 

Object nextVal = iterator. next(); 
sbuf.append(nextVal.toString ()); 

} 

this. limitValue = sbuf.toString (); 
} 

I** 

* Sets the id property. 

* @param sld the id of the limit. 

7 



public void setld(String sld) 
{ 

this. id = sld; 
} 

I** 

* Gets the id property. 

* @return the id of the limit. 

7 

public String getld() 
{ 

return this. id; 

} 

I** 

* Sets the name property. 

* @param sName the Name of the limit. 

7 

public void setName(String sName) 
{ 

this. name = sName; 

} 

I** 

* Gets the name property. 

* @return the Name of the limit. 

7 

public String getName() 
{ 

return this. name; 

} 

/** 

* Gets the limitValue associated with this Limit. 

* <5>return the Limit Value. 

7 

public String getLimitValue() 
{ 

return limitValue; 

} 

I** 

* Sets the limitValue associated with this Limit. 

* @param s the Limit Value. 

7 

public void setLimitValue(String s) 
{ 

limitValue = s; 

} 

/** 

Creates and returns a copy of itself. 
@return a Limit object 

7 

public Limit copy() 
{ 



ToldLimit retLim = new ToldLimit(); 
retLim. setld (this.getld ()); 
retLim. setName (this.getName ()); 
retLim.setLimitValue (this.getLimitValue ()); 
return retLim; 

} 

sets the Limit information in this object based on the Limit passed in 
@param lim object passed in to use in the set. 

7 

public void set(Limit lim) 
{ 

if (lim != null && lim instanceof ToldLimit) 
{ 

this.setld (lim.getld ()); 
this.setName (lim.getName ()); 
this.setLimitValue (lim.getLimitValue ()); 

} 

} 

/** 

Checks to see whether the Limit object has limit values that exceed the Limit. 
@param limit the object to check the limit against. 
@return Whether the limit was exceeded. 

7 

public boolean isLimitExceeded(Limit limit) 
{ 

if (limit instanceof ToldLimit) 
{ 

ToldLimit lim = (ToldLimit)limit; 

String checkLimitValue = lim.getLimitValue(); 

String value; 

String checkValue; 

boolean bFound = false; 

StringTokenizer userParser = new StringTokenizer(limitValue,","); 

while(userParser.hasMoreTokens ()) 

{ 

bFound = false; 

value = (String)userParser.nextToken (); 

StringTokenizer parser = new StringTokenizer(checkLimitValue,","); 

while(parser.hasMoreTokens ()) 

{ 

checkValue = (String)parser.nextToken (); 

if(checkValue.equals(value)) 

bFound = true; 

} 

//If we can't find this, the limit is exceeded 
if(lbFound) 
return true; 

} 

} 



return false; 

} 

/** 

Checks to see if the object coming in is going to exceed the limit. 

@param Imtbl the object to be tested 

@return boolean value of whether this limit was exceeded 

7 

public boolean isLimitExceeded(Limitable limitable) 
{ 

if (limitable instanceof ToldLimitable) 
{ 

ToldLimitable limit = (ToldLimitable) limitable; 
String Told = Nmit.getLimitableTolD(); 
//if there is no limitable id, we will return false 
if(Told == null) 
return false; 

StringTokenizer parser = new StringTokenizer(limitValue,", M ); 

while(parser.hasMoreTokens ()) 

{ 

String value = (String)parser.nextToken (); 
// If the Told is found in this limit, the limit is exceeded. 
// Thus, the task cannot be performed, 
if (Told.compareTo(value) == 0) 
return true; 

} 

} 

return false; 

} 

/** 

Gets the Name Value pairs of the Limit 
@return the Name/Value pairs. 

7 

public HashMap getNameValuePairsQ 
{ 

HashMap map = new HashMapQ; 
if(this.getLimitValue () != null) 
{ 

map.put( M LimitValue M ,this.getLimitValue ()); 

} 

return map; 

} 

} 

// TransactionLimit.java 

//Copyright (c) 2004. Financial Fusion, Inc. All Rights Reserved. 

package com. ffusion. entitlements; 

import java.util. Locale; 

import java.text.*; 

import java.util. HashMap; 

/** 

This class represents a single TransactionLimit. 



7 

public class TransactionLimit implements Limit, EntitlementCodes 
{ 

// Data Members 
private String id; 
private String name; 

protected String accountld; // Unique ID of the account 
protected String payeeld; // Unique ID of the payee 

protected double limit; // Limit to compare 

I** 

Constructs a new TransactionLimit object 

7 

public Transactionl_imit() 

{ 

} 

I** 

Set the accountld property 

@param idParm the accountld of the transactionLimit 

7 

public void setAccountlD(String idParm) 
{ 

this. accountld = idParm; 

} 

I** 

Get the accountld property 
<§>return accountld 

7 

public String getAccountlDQ 
{ 

return this. accountld; 

} 

/** 

Set the payeeld property 

@param idParm the payeeld of the transactionLimit 

7 

public void setPayeelD(String idParm) 
{ 

this. payeeld = idParm; 

} 

I** 

Get the payeeld property 
©return payeeld 

7 

public String getPayeelD() 
{ 

return this. payeeld; 

} 

I** 

Set the limit property 

@param the limit of the transactionLimit 



7 

public void setLimitValue(String Limit) 
{ 

try{ 

this. limit = Double.parseDouble (Limit); 

} 

catch( NumberFormatException e ){ 
} 

} 

J** 

* Gets the limitValue associated with this Limit. 

* @return The Limit Value. 

7 

public String getLimitValueQ 
{ 

return String.valueOf(this. limit); 

} 

I** 

Creates and returns a copy of itself, 
©return a Limit object 

7 

public Limit copy() 
{ 

TransactionLimit retLim = new TransactionLimit(); 
retLim.setld (this.getld ()); 
retLim.setAccountID (this.getAccountID ()); 
retLim. set PayeelD (this.getPayeelD ()); 
retLim.setLimitValue (this.getLimitValue ()); 
retLim. setName (this.getName ()); 
return retLim; 

} 

/** 

sets the Limit information in this object based on the Limit passed in 
@param lim object passed in to use in the set. 

7 

public void set(Limit lim) 
{ 

if (lim != null && lim instanceof TransactionLimit) 
{ 

TransactionLimit transactionLimit = (TransactionLimit)lim; 
this.setld (transactionLimit.getld ()); 
this.setName (transactionLimit. getName ()); 
this.setAccountID (transactionLimit.getAccountlD()); 
this.setPayeelD (transactionLimit.getPayeelD()); 
this.setLimitValue (transactionLimit.getLimitValue()); 

} 

} 

I** 

Checks to see whether the Limit object has limit values that exceed the Limit. 
@param limit the object to check the limit against. 



@return Whether the limit was exceeded. 

7 

public boolean isLimitExceeded(Limit checkLim) 
{ 

if(checkl_im instanceof TransactionLimit) 
{ 

TransactionLimit lim = (TransactionLimit)checkLim; 

try 

{ 

if(Double.valueOf(lim.getLimitValue()).doubleValue () > limit ) 
return true; 

} 

catch( Exception e) 
{ 

return false; 

} 

} 

return false; 

} 

/** 

Checks to see if the object coming in is going to exceed the limit. 

@param Imtbl the object to be tested 

@return boolean value of whether this limit was exceeded 

7 

public boolean isl_imitExceeded(l_imitable Imtbl) 
{ 

boolean bret = false; 
boolean bCheck = true; 
double d = this. limit; 

//If this is not a TransactionLimitable object, we won't check 

if(lmtbl instanceof TransactionLimitable) 

{ 

TransactionLimitable txnLmt = (TransactionLimitable) Imtbl; 
//If we are returning nulls out of this, we will return false 
if(this.accountld != null && txnLmt.getLimitableFromlD() == null) 
return false; 

if(this.payeeld != null && txnLmt.getLimitableTolD() == null) 
return false; 

if(txnLmt.getLimitableValue() == null) 
return false; 

//if we have an account, and they are not equal, we don't need to check 
if(this.accountld != null && !(txnLmt.getLimitableFromlD (). equals (this.accountld))) 
bCheck = false; 

//if we have an account, and they are not equal, we don't need to check 

if(bCheck && this.payeeld != null && !(txnLmt.getLimitableTolD (). equals (this.payeeld))) 

bCheck = false; 

//If we are supposed to check, and the limit is exceeded, we note that 
if(bCheck && (this. limit < txnLmt.getLimitableValue ().doubleValue ())) 
bret = true; 

} 



return bret; 

} 

/** 

sets the TransactionLimit information in this object based on the TransactionLimit passed in 
@param transactionLimit - contact that TransactionLimit settings 
public int update(Limitable Imtbl) 
{ 

return this.SUCCESS; 

} 

7 

I** 

* Sets the id property. 

* @param sld the id of the limit. 

7 

public void setld(String sld) 
{ 

this. id = sld; 
} 

/** 

* Gets the name property. 

* <§>return The Name of the limit. 

7 

public String getld() 
{ 

return this. id; 

} 

I** 

* Sets the name property. 

* @param sName the Name of the limit. 

7 

public void setName(String sName) 
{ 

this. name = sName; 

} 

I** 

* Gets the name property. 

* @return The Name of the limit. 

7 

public String getName() 
{ 

return this. name; 

} 

I** 

Gets the Name Value pairs of the Limit 
©return the Name/Value pairs. 

7 

public HashMap getNameValuePairs() 
{ 

HashMap map = new HashMap(); 
if(this.getLimitValue () != null) 



map.put("LimitValue",this.getLimitValue ()); 
if(this.getAccountlD () != null) 

map.put("Accountl D",this.getAccou ntl D ()) ; 
if(this.getPayeelD () != null) 

map.put( M PayeelD",this.getPayeelD ()); 
return map; 

} 

} 



